package assql
{
	/**
	 * The AS3 mapping for the SQL type CLOB
	 **/
	public interface Clob
	{
		/**
		 * Gets a string value from the Clob object
		 *
		 * @param pos the position to start reading characters
		 * @param len the number of characters to read
		 **/
		function getString(pos:int, len:int):String;
		
		/**
		 * Gets the length of the Clob object
		 **/
		function get length():int;
		
		/**
		 * Sets the characters of the Clob object.
		 * 
		 * @param chars the characters to write to the Clob
		 * @param pos the position in the Clob to start writing characters
		 * @param offset the offest in chars to start reading
		 * @param len the number of characters to read
		 **/
		function setString(chars:String, pos:int=0, offset:int=0, len:int=0):void;
		
		/**
		 * Truncates this Clob to the specified length
		 * 
		 * @param len the length to truncate this Clob to
		 **/
		function truncate(len:int):void;
	}
}